package com.telecom.mapper;

import com.telecom.pojo.dto.admin.meal.AdminMealPageQueryRequestDTO;
import com.telecom.pojo.dto.user.meal.UserMealPageQueryRequestDTO;
import com.telecom.pojo.entity.Meal;
import com.telecom.pojo.dto.admin.meal.AdminMealPageQueryRequestDTO;
import com.telecom.pojo.vo.admin.meal.MealRankingVO;
import com.telecom.pojo.vo.admin.setmeal.MealPageVO;
import com.telecom.pojo.vo.user.meal.MealItemVO;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;
import org.apache.ibatis.annotations.Select;

import java.util.List;

/**
 * <p>
 * 套餐表 Mapper 接口
 * </p>
 *
 * @author GWX.cz
 * @since 2025-07-31
 */
@Mapper
public interface MealMapper {

    /**
     * 新增餐品
     * 
     * @param meal 餐品信息
     * @return 影响行数
     */
    Integer insert(Meal meal);
    
    /**
     * 批量删除餐品
     * 
     * @param ids 餐品ID列表
     * @return 影响行数
     */
    int deleteBatchByIds(@Param("ids") List<Long> ids);
    
    /**
     * 修改餐品
     * 
     * @param meal 餐品信息
     * @return 影响行数
     */
    int updateById(Meal meal);
    
    /**
     * 根据ID查询餐品
     * 
     * @param id 餐品ID
     * @return 餐品信息
     */
    @Select("select * from meal where id = #{id}")
    Meal selectById(Long id);


    /**
     * 分页查询餐品列表（使用PageHelper自动分页）
     *
     * @param queryRequest 查询条件
     * @return 餐品列表
     */
    List<MealPageVO> selectPageByCondition(AdminMealPageQueryRequestDTO queryRequest);

    List<MealItemVO> userSelectPageByCondition(UserMealPageQueryRequestDTO queryRequest);


    // ==================== 工作台统计方法 ====================

    /**
     * 获取热门套餐排行（前10条）
     *
     * @return 热门套餐排行列表
     */
    List<MealRankingVO> getHotMealRanking();



}
